home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 013a / pprint55.zip / PPRINT.DOI < prev    next >
Text File  |  1991-11-14  |  24KB  |  639 lines

  1.  
  2.  
  3.         ATTENTION:  This is a sample text of how to use the new printer
  4.         codes for PPRINT.  The PPRINT.DOC file was generated using this
  5.         file.  This file is not complete, but is provided for your
  6.         review to learn how to use the /DF parameter and codes.
  7.  
  8.  
  9.                                   P P R I N T
  10.  
  11.  
  12.  
  13.  
  14.                            Users Guide and Reference
  15.  
  16.  
  17.  
  18.  
  19.           -------------------------------------------------------
  20.           A General purpose printing system for all computers and
  21.           printers
  22.           -------------------------------------------------------
  23.  
  24.  
  25.                                     Shareware
  26.  
  27.                                        by
  28.  
  29.                                    Patri-Soft
  30.                                   (ASP Member)
  31.  
  32.                               (714) 352-2820 (Voice)
  33.                               (714) 352-2825 (BBS)
  34.                               (714) 352-1527 (FAX)
  35.  
  36.                                    Version 5.5
  37.                                   September 1991
  38.  
  39.  
  40.                                           ┌─────────┐
  41.                                     ┌─────┴───┐     │              (tm)
  42.                                     │         │o    │──────────────────
  43.                                     │   ┌─────┴╨──┐ │  Association of
  44.                                     │   │         │─┘  Shareware
  45.                                     └───│    o    │    Professionals
  46.                                     ────│    ║    │────────────────────
  47.                                         └────╨────┘    * Member *
  48.  
  49.  
  50.                       Support BBS --  Patriquin's BBS
  51.                              714-352-2825 (DATA)
  52.  
  53.  
  54.                 Copyright 1986, 1987, 1988, 1989, 1991 by Patri-Soft
  55.  
  56. $h1
  57.      PPRINT  Version 5.5  &&MTHYEAR        Copyright &&YR by Patri-Soft
  58. $h2
  59.      ______________________________________________________________________
  60. $toc
  61. $h1
  62.      PPRINT  Ver. 5.5  &&MTHYEAR       Copyright &&YR  Patri-Soft  Page &&P
  63. $h3
  64.  
  65. $T1   Introduction
  66.       ------------
  67.  
  68.       PPRINT is a general purpose print utility that can be used with
  69.       HP laser or other printers.
  70.  
  71.       PPRINT will scan a directory and select files for printing.
  72.       Print control parameters govern the print process.  A special
  73.       print feature for the HP laserjet printer allows printing
  74.       two pages on both halves of a side of paper.  This is especially
  75.       nice for printing large documents as it saves paper and print
  76.       time.
  77.  
  78.       PPRINT is special and unique because it is customisable to
  79.       any printer type.  It also allows you to access printer
  80.       features not normally availaable for printing normal text files.
  81.  
  82.       I know there are too many command parameters for each user to
  83.       learn.  PPRINT has all these features to support the many
  84.       different printers and features available today.  I have designed
  85.       PPRINT to provide be a single utility that will accomplish most
  86.       all print tasks.  An installation can standardize on one one print
  87.       utility even though it has users with many different kinds of
  88.       printers.
  89.  
  90.       Type the PPRINT command without parameters to get help about
  91.       command parameters available.  Once you learn the parameters you
  92.       use most often, set up DOS batch files to make printing easier.
  93.  
  94.       If you have questions, problems, ideas, or requests, please
  95.       don't hesitate to contact me through my online support BBS.
  96.       You are allowed immediate access the first call.  The number
  97.       is 714-352-2825.
  98. $PAGE
  99. $T1   Command Definition
  100.       ------------------
  101.  
  102.       PPRINT allows many command parameter switches to be specified to
  103.       customize the printing process.  All these parameters are
  104.       optional. The command format and switch parameters are described
  105.       below.  A quick review of command parameters is always available
  106.       by entering the PPRINT command with no parameters.
  107.  
  108. $t2   COMMAND FORMAT:
  109.  
  110.       PPRINT  filespec  [ (/ switches) ]
  111.  
  112.  
  113.       filespec
  114.           Enter a DOS file specification.  Pathnames and standard DOS
  115.           wildcard characters are allowed.
  116.  
  117. $BARS
  118.           You may optionally supply a file containing a list of input file
  119.           names.  Create a file containing a filename or complete pathname
  120.           on each line.  Specify the name of this file as the filename
  121.           for PPRINT and add the "@" character before the name.  The list
  122.           of files will be processed as if they were all specified on the
  123.           input command line.
  124.  
  125.           For file list processing, PPRINT understands the output of the
  126.           DOS DIR command.  You may use the DOS redirection feature to
  127.           direct DIR output to a file, edit the file to add or remove
  128.           entries, and then provide this to PCOPY as input.  For example:
  129.  
  130.               DIR A: >DIRLIST
  131.               (edit dirlist)
  132.               PPRINT @DIRLIST B:
  133. $BARE
  134.  
  135. $T2   Command Parameters
  136.       ------------------
  137.  
  138. $x3   /AP  --  Set PIFONTA
  139.       /AP       Set printer to print using PI FONT A character set.
  140.                 For laser and other compatible printers.
  141.                 (See also Printer Definition file)
  142.  
  143.  
  144. $x3   /B:  --  Begin with filename
  145.       /B:filename  When a wildcard name is supplied to indicate
  146.                 multiple files are to be printed, this parameter
  147.                 indicates to skip all files until this filename
  148.                 is found.
  149.  
  150.  
  151. $x3   /BA  --  Batch processing
  152.       /BA       BAtch command operation.  Causes PPRINT to ignore
  153.                 keystrokes entered during processing and to
  154.                 immediately end terminate processing when all
  155.                 printing is complete.  You will not be asked to press
  156.                 any key to erase the print status window.
  157.  
  158.  
  159. $page
  160. $x3   /BM  --  Bottom margin lines
  161.       /BM:nn    Number of lines of bottom margin
  162.  
  163.  
  164. $x3   /BW  --  Black & WHite mode
  165.       /BW       Force PPRINT to use black and white screen
  166.                 colors instead of its normal default attributes.
  167.  
  168.  
  169. $X3   /C   --  Compressed printing
  170.       /C        Sends code to printer to force compressed print.
  171.  
  172.  
  173. $X3   /CO: --  Multiple copies
  174.       /CO:nn    Specify the number of copies of each file to be
  175.                 printed.
  176.  
  177.  
  178. $X3   /Cn  --  Alternate display colors
  179.       /C2 /C3   These options change PPRINT's screen colors.  If you
  180.                 like the colors they produce over the standard colors,
  181.                 specify them using the SET PPRINT=/C2 command.  This
  182.                 will place them in the DOS environment where PPRINT can
  183.                 use them for each execution.
  184.  
  185.  
  186. $X3   /DB  --  Double strike mode
  187.       /DB       Set printer to print using its Double Strike mode.
  188.                 (See also Printer Definition file)
  189.  
  190.  
  191. $BAR7
  192. $X3   /DF      Document formatting codes included
  193.       /DF       Document Formatting.  The input file to be printed is
  194.                 prepared with PPRINT document formatting codes.  The
  195.                 codes allow PPRINT to format the document with page
  196.                 breas, headings, footings, and Table of Contents.
  197.  
  198.                 See the Document Formatting section of this manual
  199.                 more information about this feature.
  200.  
  201.  
  202. $X3   /DS  --  Double Space
  203.       /DS       Double space printed output
  204.  
  205.  
  206. $page
  207. $X3   /D:  --  Select files based on date
  208.       /D:[(]xxx Date.  Select files based on the relationship between
  209.          [)]    their last update date and the date specified.  This
  210.          [=]    parameter includes a date or number of days value.
  211.                 It may also contain a modifier that reverses or
  212.                 modifies the use of the date specified.
  213.  
  214.                 When xxx contains a date the date is compared to the
  215.                 last update date of the file.  The last update date
  216.                 of the file is the date contained in its directory
  217.                 entry.  The file is selected if the condition specified
  218.                 by the condition modifier is met.  The condition
  219.                 modifier meanings are:
  220.  
  221.                   '(' =  Select files whose date is older than the
  222.                          date specified.
  223.  
  224.                   ')' =  Select files whose date is newer than the
  225.                          date specified. (default if none specified)
  226.  
  227.                   '=' =  Select files whose date is equal to the date
  228.                          specified.
  229.  
  230.                 Date values may be specified in any of these formats:
  231.                     MM/DD/YY   MM-DD-YY   DDMMMYY
  232.                     12/31/80   12-31-80   31DEC80
  233.  
  234.                 If xxx contains a numeric value, that positive number
  235.                 is used to calculate a date value a number of days
  236.                 prior to the current date.  Then that date is used
  237.                 as in the calculation above.
  238.  
  239.                 Example:
  240.                 /D:(1JAN86  - Process files updated before 1JAN86
  241.                 /D:)1JAN86  - Process files updated after 1JAN86
  242.                 /D:=1JAN86  - Process files updated 1JAN86
  243.                 /D:(5  - Process files modified prior to 5 days ago
  244.                 /D:)5  - Process files modified within the last 5 days
  245.                 /D:=5  - Process files modified 5 days ago
  246.  
  247.  
  248. $X3   /E   --  Emphasized printing
  249.       /E        Sends code to printer to force emphasized print.
  250.  
  251.  
  252. $page
  253. $X3   /EQ  --  End Quick without waiting for keypress
  254.       /EQ       PPRINT normally asks the user to press a key before
  255.                 removing the print status window at the end of
  256.                 processing.  This parameter causes PPRINT to END
  257.                 QUICKLY and not wait for a user key press.
  258.  
  259.  
  260. $X3   /EX  --  Print headers with expanded print
  261.       /EX       Attempt to print the header and footer lines using
  262.                 dot matrix expanded print options.  If there is not
  263.                 enough room on the line this option will be ignored.
  264.  
  265.  
  266. $X3   /F   --  Add page footings with filename and page number
  267.       /F        Print page footings at the bottom of each page.  This
  268.                 makes thumbing through listings to find a specific
  269.                 file much easier.
  270.  
  271.  
  272. $X3   /FC  --  Set Courier type face
  273.       /FC       Set printer to print using Courier type face.
  274.                 For laser and other compatible printers.
  275.                 (See also Printer Definition file)
  276.  
  277.  
  278. $X3   /FE  --  Set Prestiege Elite type face
  279.       /FE       Set printer to print using Prestiege Elite type face.
  280.                 For laser and other compatible printers.
  281.                 (See also Printer Definition file)
  282.  
  283.  
  284. $X3   /FG  --  Set Gothic Type face
  285.       /FG       Set printer to print using Gothic Elite type face.
  286.                 For laser and other compatible printers.
  287.                 (See also Printer Definition file)
  288.  
  289.  
  290. $X3   /FH  --  Set Helvetica type face
  291.       /FH       Set printer to print using Helvetica type face.
  292.                 For laser and other compatible printers.
  293.                 (See also Printer Definition file)
  294.  
  295.  
  296. $X3   /FL  --  Set Line Printer type face
  297.       /FL       Set printer to print using Line Printer type face.
  298.                 For laser and other compatible printers.
  299.                 (See also Printer Definition file)
  300.  
  301.  
  302. $page
  303. $X3   /FP  --  Add footer lines with page number only
  304.       /FP       Print Footer line that contains Page number only.
  305.  
  306.  
  307. $X3   /FT  --  Set Times Roman type face
  308.       /FT       Set printer to print using Times Roman type face.
  309.                 For laser and other compatible printers.
  310.                 (See also Printer Definition file)
  311.  
  312.  
  313. $X3   /G   --  Add indentation guides for C source files
  314.       /G        For printing C language source files.  This option
  315.                 prints ruler lines to help follow IF and DO sets
  316.                 of lines down and across pages.
  317.  
  318.  
  319.  
  320. $X3   /HD  --  Add header lines with filename, date, and page
  321.       /HD       Print Header line that contains filename, date file
  322.                 was last updated, and page number.
  323.  
  324.  
  325. $X3   /HP  --  Add header lines with page numbers only
  326.       /HP       Print Header line that contains Page number only.
  327.  
  328.  
  329. $X3   /HT  --  Add headings and prompt for header title
  330.       /HT       PPRINT will prompt you for heading information to
  331.                 be placed in heading and footing lines.
  332.  
  333.  
  334. $X3   /HT: --  Add headings with specified text
  335.       /HT:ccc   Specify heading information to be placed in heading
  336.                 and footing lines.  Since DOS does not allow spaces
  337.                 in command lines, enter an underline character '_'
  338.                 wherever you want a space printed.  PPRINT will
  339.                 substitute a space in those positions.
  340.  
  341.                 I.E.  PPRINT *.BAT/ht:Disk_Batch_Files
  342.  
  343.  
  344. $X3   /IT  --  Set Italics font
  345.       /IT       Use printers Italics print mode.
  346.                 (See also Printer Definition file)
  347.  
  348.  
  349. $page
  350. $X3   /JU  --  Set printer's auto justification mode
  351.       /JU       Use printer's Auto Justification Mode
  352.                 (See also Printer Definition file)
  353.  
  354.  
  355. $X3   /LA  --  Set printer's lasdscape mode
  356.       /LA       Set printer's Landscape print Mode
  357.                 (See also Printer Definition file)
  358.  
  359.  
  360. $X3   /LC  --  Compress repeated spaces to a single line
  361.       /LC       Compress all sets of spaces to one space in each
  362.                 print line.
  363.  
  364.  
  365. $X3   /LD  --  Set printer's Line Draw character set
  366.       /LD       Set printer to print using LINEDRAW character set.
  367.                 For laser and other compatible printers.
  368.                 (See also Printer Definition file)
  369.  
  370.  
  371. $X3   /LE  --  Set printer's Legal character set
  372.       /LE       Set printer to print using LEGAL character set.
  373.                 For laser and other compatible printers.
  374.                 (See also Printer Definition file)
  375.  
  376.  
  377. $X3   /LJ  --  Left Justify lines to be printed
  378.       /LJ       Left Justify each line to be printed.
  379.  
  380.  
  381. $X3   /LL: --  Set line length
  382.       /LL:nn    Number of characters to be allowed for each print
  383.                 line.  Longer lines will be truncated.
  384.  
  385.  
  386. $X3   /LM: --  Set left margin size in characters
  387.       /LM:nn    Number of characters for the left margin.
  388.  
  389.  
  390. $X3   /LO: --  Print at Offset from beginning of line
  391.       /LO:nn    Ignore the first n characters and start printing
  392.                 with the nnth character in each print line. (Offset)
  393.  
  394.  
  395. $X3   /LP: --  Set lines per page
  396.       /LP:nn    Lines per page.  66 lines assumed.  (11 inch * 6 lpi)
  397.  
  398.  
  399. $page
  400. $X3   /LPTn -  Set alternate printer
  401.       /LPTn     Specify /LPT1 or /LPT2 or /LPT3 or /LPT4 to indicate the
  402.                 alternate printer PPRINT is to direct all output to.
  403.                 This has the same effect as specifying /PD:LPTn.
  404.  
  405.                 Note, specification of LPT2 will cause PPRINT to attempt
  406.                 to use a printer definition file of PPRINT2.DEF. This
  407.                 allows a special printer definition file to be set up
  408.                 for different printers attached to your system.  If the
  409.                 special printer definition file is not found, PPRINT
  410.                 will look for the standard printer definition file
  411.                 PPRINT.DEF.
  412.  
  413.  
  414. $X3   /LQ  --  Set printer's Letter Quality mode
  415.       /LQ       When the printer has letter quality mode, this parm
  416.                 activates it.
  417.                 (See also Printer Definition file)
  418.  
  419.  
  420. $X3   /ML: --  Set maximum lines per file to print
  421.       /ML:nn    Indicate the maximum number of lines to be printed.
  422.  
  423.  
  424. $X3   /MP: --  Set maximum pages per file to print
  425.       /MP:nn    Indicate the maximum number of pages to be printed.
  426.  
  427.  
  428. $X3   /N   --  Add line numbers at begin of each line
  429.       /N        Print a line number before each line printed.  Useful
  430.                 for printing program source listings.
  431.  
  432.  
  433. $X3   /NC  --  Ignore print control characters found in file
  434.       /NC       Ignore print control characters found in input lines.
  435.                 You may also want to specify /NE.
  436.  
  437.  
  438. $X3   /ND  --  Ignore duplicate lines found in file
  439.       /ND       PPRINT will search for duplicate input lines and
  440.                 ignore them.  This feature can be used to take any
  441.                 sorted text file and remove duplicate lines.
  442. $page
  443. $X3   /NE  --  Do not eject paper
  444.       /NE       Do not eject the paper by inserting Form Feed
  445.                 characters.
  446.  
  447.                 SPECIAL FEATURE:  You can use this parameter to
  448.                 change a input file to upper case, lower case or
  449.                 for any of the other data manipulation features
  450.                 of PPRINT.  This causes PPRINT to pass the file
  451.                 through without added print control.
  452.  
  453.                 The following example reads file X.TXT and creates
  454.                 file Y.TXT and converts it to upper case and
  455.                 removes duplicate lines.
  456.  
  457.                    PPRINT X.TXT/PD:Y.TXT/PU/ND/NE
  458.  
  459.                 The next example takes the first 500 lines of file
  460.                 X.TXT and creates file Y.TXT.
  461.  
  462.                    PPRINT X.TXT/PD:Y.TXT/NE/ML:500
  463.  
  464.  
  465. $X3   /NF  --  Ignore form feed characters found in file
  466.       /NF       Ignore Form Feed characters found in input files.
  467.                 Normally when PPRINT finds a form feed it honors
  468.                 it and skips to the top of the next page.  With
  469.                 /NF specified, the form feed is removed from the
  470.                 input and ignored.
  471.  
  472.  
  473. $X3   /NI  --  Ignore PPRINT= DOS Environment variable data
  474.       /NI       No envIronment variables.  Causes PPRINT to ignore any
  475.                 PPRINT= DOS environment variable parameters during
  476.                 processing.
  477.  
  478.  
  479. $X3   /NT  --  Do not expand tabs in file
  480.       /NT       Do not expand tabs in input file.
  481.  
  482.  
  483. $X3   /NV  --  Disable PPRINT's display of lines during processing
  484.       /NV       Disables PPRINT display of file lines on its display
  485.                 during processing.
  486.  
  487.  
  488. $X3   /NW  --  No Windows.  Use standard DOS output for display
  489.       /NW       No Window causes PPRINT operation to write to the
  490.                 display like other DOS commands and not display and
  491.                 update a full screen status window during processing.
  492. $page
  493. $X3   /PA  --  Payse before each page is printed
  494.       /PA       Pause before each page is printed.  Use on single
  495.                 sheet printers to allow each new page to be placed
  496.                 in the printer.
  497.  
  498.  
  499. $X3   /PD: --  Alternate printer device or filename
  500.       /PD:xxxx  Alternate print device name.  /PD:LPT2 will cause
  501.                 all output to be directed to printer 2.  LPT1 is
  502.                 assumed.  This can also be the name of a DOS file.
  503.  
  504.  
  505. $X3   /PF: --  Use alternate PPRINT printer definition file
  506.       /PF:xxxx  Specification of an alternate printer definition
  507.                 file name.  You may cause PPRINT to use any printer
  508.                 definition file you wish.  Just specify the name of
  509.                 the file as part of the /PF: parameter as shown by the
  510.                 following example. Any valid DOS file name may be used.
  511.  
  512.                     /PF:LASER2.DEF  or  /PF:LASER.2
  513.  
  514.  
  515. $X3   /PI  --  Set printer's PI font
  516.       /PI       Set printer to print using PI FONT character set.
  517.                 For laser and other compatible printers.
  518.                 (See also Printer Definition file)
  519.  
  520.  
  521. $X3   /PL  --  Convert all lines to lower case characters
  522.       /PL       Convert all print lines to lower case.
  523.  
  524.  
  525. $X3   /PI  --  Convert all lines to upper case characters
  526.       /PU       Convert all print lines to upper case.
  527.  
  528.  
  529. $X3   /PR  --  Set printer's Proportional print mode
  530.       /PR       Use printer's Proportional print mode.
  531.                 (See also Printer Definition file)
  532.  
  533.  
  534. $X3   /PS  --  Set printer's Print over page perferation
  535.       /PS       Print file over page perforation. Also consider
  536.                 /NE.
  537.                 (See also Printer Definition file)
  538. $page
  539. $X3   /P%  --  Set 8.5 size type
  540.       /P5       Set printer to print using 8.5 point type
  541. $X3   /P%  --  Set 7 size type
  542.       /P7       Set printer to print using 7 point type
  543. $X3   /P%  --  Set 8 size type
  544.       /P8       Set printer to print using 8 point type
  545. $X3   /P%  --  Set 10 size type
  546.       /P10      Set printer to print using 10 point type
  547. $X3   /P%  --  Set 12 size type
  548.       /P12      Set printer to print using 12 point type
  549. $X3   /P%  --  Set 14 size type
  550.       /P14      Set printer to print using 14 point type
  551.                 For laser and other compatible printers.
  552.                 (See also Printer Definition file)
  553.  
  554.  
  555. $X3   /R   --  Add a ruler at the top of each page
  556.       /R        Print a ruler at the top of each page of output.
  557.  
  558.  
  559. $X3   /RE  --  Enter PPRINT registration codes
  560.       /RE       When you register PPRINT, you will be sent a
  561.                 registration code and serial number.  Use this
  562.                 option to activate registration processing.
  563.  
  564.  
  565. $X3   /RO  --  Set printer's Roman character set
  566.       /RO       Set printer to print using ROMAN character set.
  567.                 For laser and other compatible printers.
  568.                 (See also Printer Definition file)
  569.  
  570.  
  571. $X3   /RSET -  Reset printer with reset codes and end
  572.       /RSET     Is the opposite of /SET parameter.  Use to cause
  573.                 PPRINT to send printer reset codes to reset the
  574.                 printer as if PPRINT processing for the specified
  575.                 command were terminating.  Allows you to reset
  576.                 the printer for other applications.
  577.  
  578.  
  579. $X3   /RX  --  Set printer's ROMANX character set
  580.       /RX       Set printer to print using ROMANX character set.
  581.                 For laser and other compatible printers.
  582.                 (See also Printer Definition file)
  583. $page
  584. $X3   /S   --  System - Scan all directories for files to print
  585.       /S        laSer printer.  2-up side by side page printing
  586.                 in compressed format.  Requires lanscape font.  This
  587.                 may be used with /2D or /2E or /PA to get double
  588.                 sided output on laser printer.
  589.  
  590.  
  591. $X3   /SC  --  Set printer's Script character set
  592.       /SC       Use printers Script print mode.
  593.                 (See also Printer Definition file)
  594.  
  595.  
  596. $X3   /SET --  Use PPRINT to set printer options.  Do not print a file
  597.       /SET      Changes the function of PPRINT.  When /SET is specified,
  598.                 PPRINT will send all appropriate control codes to set
  599.                 the printer for processing and will terminate. No files
  600.                 will be printed.
  601.  
  602.                 This parameter allows you to take advantage of PPRINT
  603.                 printer setup features for other applications,
  604.  
  605.  
  606. $X3   /SL: --  Start printing starting at file line number
  607.       /SL:nnn   Start or restart printing with the nnth line of
  608.                 the file.  Previous lines will be skipped.
  609.  
  610.  
  611. $X3   /SP: --  Start printing starting at page number
  612.       /SP:nnn   Start or restart printing with page number nnn.
  613.                 Previous pages will be skipped.
  614.  
  615.  
  616. $X3   /S6  --  Set printer to 6 lines per inch
  617.       /S6       Use printer's 6 line per inch mode.
  618.                 (See also Printer Definition file)
  619.  
  620.  
  621. $X3   /S8  --  Set printer to 8 lines per inch
  622.       /S8       Use printer's 8 line per inch mode.
  623.                 (See also Printer Definition file)
  624.  
  625.  
  626. $X3   /T   --  Test PPRINT command.  Do not print
  627.       /T        Test the command.  Use this switch when you
  628.                 would like to test the command entered without
  629.                 actually printing any files.
  630.  
  631.                 Messages will indicate what will happen if the command
  632.                 is executed without the /T switch.
  633. $page
  634. $X3   /TB: --  Start printing when text found in file
  635.       /TB:xxx   Specify text to be located in the input file.  When
  636.                 the text is found, the following data will be printed.
  637.  
  638.  
  639.